home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1997 April: Mac OS SDK / Dev.CD Apr 97 SDK1.toast / Development Kits (Disc 1) / Apple Game Sprockets / Release Notes / DrawSprocket Release Notes next >
Encoding:
Text File  |  1997-01-21  |  4.6 KB  |  103 lines  |  [TEXT/CWIE]
  1. DrawSprocket 1.1
  2. Release Notes
  3. ----------------
  4.  
  5. For a detailed list of changes from version 1.01 to 1.1, please read the
  6. change list at the end of this document.
  7.  
  8. Important Note!:  One DebugStr slipped into the release version of DrawSprocket 1.1.  We're 
  9. qualifying a new version that doesn't have it, but for the moment, avoid invalidating any
  10. rectangle that lies entirely off the screen, or your game will crash on machines without
  11. MacsBug.
  12.  
  13. Please report all bugs to sprockets@adr.apple.com!
  14.  
  15. Release Components
  16. ------------------
  17.  
  18.     DrawSprocket Release Notes                - this file
  19.     
  20.     DrawSprocket API v1.1 ERS.pdf            - API documentation
  21.     
  22.     DSp Debugging Tips                        - tips for debugging DSp programs
  23.     
  24.     DrawSprocket.h                            - the header file to compile with
  25.     
  26.     DrawSprocketStubLib                        - link library
  27.     DrawSprocketLib                            - release version of the library
  28.     DrawSprocketDebugLib                    - debugging version of the library
  29.     
  30.     DrawSprocketTest                        - test program
  31.     DrawSprocketTest.µ                        - test program project file
  32.     DrawSprocketTest Sources                - test program source code
  33.     
  34.     DSp Stereo View                            - stereoscopic imaging example code
  35.     DSp Stereo View.µ                        - stereoscopic imaging project file
  36.     DSp Stereo View Sources                    - stereoscopic imaging source code
  37.  
  38. WARNING: don't place both the debugging and non-debugging versions of the
  39. library in the search path or you will not be sure which version you are
  40. using.
  41.  
  42. Dependencies
  43. ------------
  44.  
  45. DrawSprocket relies upon the Display Manager 2.0 or later.  It must be present
  46. on your system (and the end-user's system) for DrawSprocket to run.
  47.  
  48. DrawSprocket requires the latest Universal Headers -- version 2.1.2 or later.
  49. You can find them on E.T.O. #20, the MacOS SDK CD-ROMs, Apple's web-site, or
  50. a number of other locations.  If you have a problem with the "OptionBits" type
  51. usage, then you aren't using the latest Types.h file.
  52.  
  53. Compatability with Prereleases
  54. ------------------------------
  55.  
  56. DrawSprocket 1.1 is fully compatible with previous releases of DrawSprocket.
  57.  
  58. Changes from 1.01 to 1.1
  59. ------------------------
  60.  
  61.     - Enhancement:  DSp now has two blitter routines: DSpBlit_Faster(),
  62.         and DSpBlit_Fastest().  DSpBlit_Faster() does not check for scaling
  63.         or interpolation.
  64.     - Enhancement:  Stereoscopic imaging now supported.  Specify a context
  65.         option of kDSpContextOption_Stereoscopic, and when calling
  66.         DSpContext_GetBackBuffer() use buffer kinds of kDSpBufferKind_LeftEye
  67.         and kDSpBufferKind_RightEye.  When you call DSpContext_SwapBuffers(),
  68.         DrawSprocket will do the rest of the work.  Requires GoggleSprocket and
  69.         a device driver for a stereoscopic imaging device.
  70.     - Enhancement:  DSpFindBestContext() will now ignore devices that
  71.         already have a reserved context associated with them.  This means
  72.         that it is now trivial to support multiple displays in your game,
  73.         just call DSpFindBestContext() in a loop and reserve the contexts
  74.         it returns to you.  When it returns an error, there are no more
  75.         contexts/devices that would match your requested attributes.  If you want
  76.         to make sure your contexts are full screen on the device (as opposed
  77.         to being centered), do a DSpContext_GetAttributes() on the context
  78.         returned from DSpFindBestContext() and use the width and height
  79.         of the actual context (they will be larger if the display can't
  80.         be changed to a lower resolution, or the same if it can) in your
  81.         attributes when you call DSpContext_Reserve().
  82.     - Enhancement:  Changed to custom list code (was using PowerPlant LList)
  83.         and saved 14k.
  84.     - Enhancement:  When selecting a context priority is given to display modes
  85.         that do not require user confirmation.
  86.     - Enhancement:  The debug library now performs more sanity checks on the
  87.         arguments passed into the dirty rect inval calls.
  88.     - Bug Fix:  DSpContext_SetVBLProc() was incorrectly setting the user RefCon
  89.         to the piggback VBL proc ptr.
  90.     - Bug Fix:  Was not saving previous display state immediately before activating
  91.         a context, only when DSp was started up.  This was bad if the user
  92.         changed display settings (with Monitors CDEV) after a program was started
  93.         but before activating a context.
  94.     - Bug Fix:  Was not correctly returning confirm switch warning from
  95.         DSpContext_SetState().
  96.     - Bug Fix:    DSpUserSelectContext() would sometimes return a NULL context.
  97.     - Bug Fix:  There were several problems associated with
  98.         DSpContext_SetDirtyRectGridSize().  Any AltBuffers created after the call
  99.         continued to have the default grid size rather than the newly requested size.
  100.         This could cause crashes, and/or memory problems and/or sever graphics
  101.         articating.
  102.     - Bug Fix:  The debug library now checks to see if the target context is active
  103.         when entering DSpContext_SetDirtyRectGridSize().